GetLocalAxes {Solid Element}

GetLocalAxes

Syntax

SapObject.SapModel.SolidElm.GetLocalAxes

VB6 Procedure

Function GetLocalAxes(ByVal Name As String, ByRef a As Double, ByRef b As Double, ByRef c As Double) As Long

Parameters

Name

The name of an existing solid element.

a, b, c

The local axes of the solid element are defined by first setting the positive local 1, 2 and 3 axes the same as the positive global X, Y and Z axes and then doing the following: [deg]

1.
Rotate about the 3 axis by angle a.

2.
Rotate about the resulting 2 axis by angle b.

3.
Rotate about the resulting 1 axis by angle c.

Remarks

This function retrieves the local axis angle assignment for solid elements.

The function returns zero if the assignment is successfully retrieved; otherwise it returns a nonzero value.

VBA Example

Sub GetSolidElementLocalAxisAngle()

'dimension variables

Dim SapObject as cOAPI

Dim SapModel As cSapModel

Dim ret As Long

Dim a As Double, b As Double, c As Double

'create Sap2000 object

Set SapObject = CreateObject("CSI.SAP2000.API.SapObject")

'start Sap2000 application

SapObject.ApplicationStart

'create SapModel object

Set SapModel = SapObject.SapModel

'initialize model

ret = SapModel.InitializeNewModel

'create model from template

ret = SapModel.File.NewSolidBlock(300, 400, 200, , , 2, 2, 2)

'assign local axes angles

ret = SapModel.SolidObj.SetLocalAxes("ALL", 30, 40, 50, Group)

'create analysis model

ret = SapModel.Analyze.CreateAnalysisModel

'get solid element local axis angle

ret = SapModel.SolidElm.GetLocalAxes("1", a, b, c)

'close Sap2000

SapObject.ApplicationExit False

Set SapModel = Nothing

Set SapObject = Nothing

End Sub

Release Notes

Initial release in version 11.00.

See Also